home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 1
/
Cream of the Crop 1.iso
/
BBS
/
CO102.ARJ
/
CO-LANG.DOC
< prev
next >
Wrap
Text File
|
1992-06-11
|
28KB
|
802 lines
.FL+
WARNING: DO NOT ATTEMPT TO RUN THIS FILE AS A SOURCE FILE!
.FL-
.>Q
==========================================================================
CROSSOVER LANGUAGE MANUAL
Version 1.02
==========================================================================
This file describes all of the commands currently supported by Crossover
and gives simple examples of the operation of most of them.
Here is the format that will be used:
--------------------------------------------------------------------------
command format
[command name]
output (if any)
<version #> implementation or revision
description of command operation
{EXAMPLE}
Source File Screen/printer
-------------------- ------------------ -----------------
source file text text output to text output to
shown here disk file shown screen or printer
here shown here
--------------------------------------------------------------------------
A summary of all commands appears at the end of this listing
==========================================================================
==========================================================================
.CR
[CARRIAGE RETURN]
File output
<1.00> implemented
Sends a carriage return and line feed to the output file. Appended to
the source file unless the .NA command is used.
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
."User Name: User Name:John Doe
."John Doe User Age:21
.CR
."User Age:
."21
.CR
==========================================================================
.DT
[DATE & TIME]
Screen prompt
File output
<1.00> implemented
This command displays the current date and time. It also writes
the date and time to the output file which is appended to the source
file unless the .NA command is used.
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
."Date: Date:7/30/90 16:32 Date & Time:7/30/90 16:32
Date & Time:
.DT
.CR
==========================================================================
.NA
[NO APPEND]
File output
<1.00> implemented
<1.01> revised
All user inputs and file directed output is normally appended to the
end of your source file when program operation is ended. This command
permits you to toggle this appending. If .NA is used, your output
will be stored in an output file with the same file name as your
source file, but a file extension of ".ASC" Using the .NA again will
toggle the appending to its original setting.
==========================================================================
.SBprompt
[SPACEBAR]
Screen prompt
<1.00> implemented
<1.01> revised
This command causes the user display to pause and wait for them to
press a key. "prompt" represents your prompt message which is shown
to the user while the system waits for input. If "prompt" is omitted,
the default prompt "Press <SPACE-BAR>" is displayed.
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
.SBPress any key Press any key
.SB Press <SPACE-BAR>
==========================================================================
.UTn
[USER TEXT]
Screen prompt
File output
<1.00> implemented
<1.01> revised
Permits the user to input up to 99 lines of text, 75 characters wide.
The parameter n sets the maximum number of lines the user may enter,
in the absence of a parameter the default is the maximum of 99 lines.
Also prevents the input of any dot commands by the user except for the
.SB command by appending two spaces (ASCII 32) to the head of each line.
Some user editing functions are provided, similar to internal editing
commands on most BBS systems. To stop entering text the user must enter
a blank line (carriage return).
Several options are given upon exit from the text entry mode of this
command. They are:
C - Continue. Returns user to text entry mode at the point they quit.
S - Save. Saves the text to the output file as entered.
A - Abort. Discards entered text and exits.
D - Display. Displays all text entered and line numbers. Display will
pause when line numbers displayed exceed the user's screen length
less 4 lines.
E - Edit. Permits the user to edit individual lines. Similar to the
edit options found on RA/QBBS message entry.
Text entered is appended to source file unless .NA command is used or
the user aborts the entry.
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
.UT16 Up to 16 lines of User prompted to
text entered by enter text
user.
==========================================================================
.>x
[FORWARD DIRECTED BRANCH]
No output
<1.00> implemented
Skips forward in the source file to the NEXT occurance of .@x where
"x" may be any standard ASCII character.
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
Hello Hello
.>A Good-bye
Hi There
.@A
Good-bye
==========================================================================
.<x
[REVERSE DIRECTED BRANCH]
No output
<1.00> implemented
Resets the source file and searches for the FIRST occurance of .@x
where "x" may be any standard ASCII character.
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
.>A Hello
.@B Good-bye
.CR
Good-bye
.CR
.>C
.CR
Howdy!
.CR
.@A
Hello
.CR
.<B
.@C
==========================================================================
.[xyz]
[MULTIPLE-CHOICE FORWARD BRANCH]
No output
<1.00> implemented
Waits for user entry of any keyboard character found enclosed in the
brackets then skips forward in the source file to the NEXT occurance
of .@x where "x" represents character entered by user.
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
Enter A,B or C Enter A,B or C:<B>
.[ABC] You entered B!
.@A Bye!
.CR
You entered A!
.CR
.>D
.@B
.CR
You entered B!
.CR
.>D
.@C
.CR
You entered C!
.CR
.@D
Bye!
==========================================================================
.@x
[MARKER]
No output
<1.00> implemented
Marks stopping points for branching commands. "x" may be any standard
ASCII character.
{EXAMPLE}
See most other examples.
==========================================================================
.$n_
[STRING INPUT]
Screen echo
File output
<1.00> implemented
Permits user to enter a single line of text "n" characters long and
prompts user to verify that entry was correct. Sends input to the
output file which is appended to source file unless .NA command is
used. This command will display the text that was entered by the
user and ask them if it is correct. If their answer is NO, they
will be prompted to re-enter their text until they answer YES to
the prompt.
A trailing space may be included by putting an underline ("_") at
the end of the string.
WARNING!
Care should be used when permitting users to enter text with this
command to prevent them from entering their own dot commands.
Indiscriminate use of dot commands by users can cause havoc on an
otherwise well-oiled door. The best way to prevent this is to
add a space character ( ."_ ) to the file prior to letting them
make any input with this command.
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
Enter your name: USER NAME: JOHN Enter your name:<JOHN>
."USER NAME: _
.$20
==========================================================================
.#n
[NUMERIC INPUT]
File output
<1.00> implemented
Permits user to enter a number "n" digits long. Will accept only
the digits 0 through 9 or a decimal point.
Sends input to the output file and appends to the source file unless
the .NA command is used.
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
How old are you? USER AGE:21 How old are you?<21>
."USER AGE:
.#3
==========================================================================
.?xtext
[PROMPTED Y/N INPUT]
Screen prompt
<1.00> implemented
Displays "text" prompt and waits for user to answer "Y" or "N". In
the absence of "text" a stock prompt will be displayed. Upon entry
of a "Y" the file continues. If an "N" is entered, the file branches
forward to the next occurance of .@x where "x" may be any standard
ASCII character.
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
.?ADo you want to? Do you want to?<N>
.CR Good!
Oh, too bad.
.>B
.@A
.CR
Good!
.@B
.CR
==========================================================================
."text_
[DIRECT TEXT]
File output
<1.00> implemented
Sends text following the " mark to the output file. Appended to the
source file unless the .NA command is used. A trailing space may be
added by using an underline as the last character.
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
.".SB .SB This is the way
.CR you append space bar
This is the way commands in output!
you append space bar
commands in output!
==========================================================================
.(text
[COMMENT]
No output
<1.00> implemented
Provided to permit comments explaining source file operations that
are not displayed to user.
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
.(This is a comment This is not Neither is this
."This is not
Neither is this
==========================================================================
.CFn
[CHANGE FOREGROUND]
screen output
<1.00> implemented as registered command
<1.02> moved to freeware command list
Changes ANSI foreground color to n, where n is an integer value between
0 and 15. Color values correspond to ANSI values used in the RA/QBBS
menu system.
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
.CF14 This text is in
This text is in BOLD YELLOW
BOLD YELLOW This text is in
.CF07 light gray
This text is in
light gray
==========================================================================
.CBn!
[CHANGE BACKGROUND]
screen output
<1.00> implemented as registered command
<1.01> revised
<1.02> moved to freeware command list
Changes ANSI background color to n, where n is an integer value between
0 and 7. Color values correspond to ANSI values used in the RA/QBBS
menu system.
The ! following the integer is optional. Inclusion of this causes the
system to display a line of 80 spaces in the new background color in
order to clear the previous color from the screen. Omitting this can
cause a stripe of the previous color to be displayed on the right side
of the screen.
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
.CB0 black
black light gray
.CB07
light gray
==========================================================================
.CLS
[CLEAR SCREEN]
screen output
<1.00> implemented as registered command
<1.02> moved to freeware command list
Clears the screen
==========================================================================
.RN[xyz]
[RANDOM BRANCH]
no output
<1.00> implemented as registered command
<1.02> moved to freeware command list
Performs a random forward branch to x,y or z.
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
.RN[ABCD] Choice B
.@A Endit
Choice A
.>E
.@B
Choice B
.>E
.@C
Choice C
.>E
.@D
Choice D
.@E
Endit
==========================================================================
______________________________________________________________________
*********************** REGISTERED COMMANDS **************************
==> ATTENTION <==
The following dot commands are available only after you have registered
this software.
______________________________________________________________________
==========================================================================
.ANx
[ANSI BRANCH]
no output
<1.00> implemented
Performs a forward branch to x if user has ANSI graphics enabled
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
.ANC You have
You do not have ANSI graphics
ANSI graphics
.>D
.@C
You have
ANSI graphics
.@D
==========================================================================
.DS
[DISPLAY SCORE]
screen output
<1.00> implemented
Display current score value on screen.
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
.SS5000 Your score is:5000
Your score is: You're a winner!
.DS
You're a winner!
==========================================================================
.EO
[ERASE OUTPUT]
no file output
<1.00> implemented
Erases output file if it exists.
==========================================================================
.EXn
[EXIT]
no output
<1.00> implemented
Quit immediately and exit at error level n. No cleanup operations are
performed. Recommended for emergency escapes only. Error levels are
limited to 0 and 11 through 255. Error levels 1 through 10 are reserved
by CROSSOVER's I/O unit.
==========================================================================
.FL+
[FLASH ON]
screen output
<1.00> implemented
Turn on ANSI flashing text
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
If the next line If the next line
.FL+ FLASHES
FLASHES you have ANSI.
.FL-
you have ANSI.
==========================================================================
.FL-
[FLASH OFF]
screen output
<1.00> implemented
Turn off ANSI flashing text
{EXAMPLE}
See .FL+ command
==========================================================================
.PRtxt
[PRINT TEXT]
printer output
<1.00> implemented
Sends txt to line printer. Error condition will occur if printer is
offline.
{EXAMPLE}
Source File PRINTER
-------------------- ------------------ -----------------
.PRUser won game. User won game.
==========================================================================
.Password:txt
[PASSWORD]
screen output
<1.00> implemented
Requests user to enter password defined by txt. If incorrect, program
closes file and exits.
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
.Password:LTD Enter password:<LTD>
Welcome user! Welcome user!
==========================================================================
.PUI
[PRINT USER INFO]
printer output
<1.00> implemented
Sends user information to printer. Name, location, date, baud rate,
security level & ANSI setting. Will give error if printer is offline.
{EXAMPLE}
Source File PRINTER
-------------------- ------------------ -----------------
.PUI JOE DOE FROM ADA, OH
etc...
==========================================================================
.SExn
[SECURITY BRANCH]
no output
<1.00> implemented
Branches to x if user's security level is > n.
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
.SEA32000 You ARE a sysop
You aren't a sysop
.>B
.@A
You ARE a sysop
.@B
==========================================================================
.SSn
[SET SCORE]
no output
<1.00> implemented
Sets score to integer value determined by n
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
.SS5000 Your score is:5000
Your score is: You're a winner!
.DS
You're a winner!
==========================================================================
.TDn
[TIME DELAY]
no output
<1.00> implemented
Waits n seconds
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
Please wait 10 sec. Please wait 10 sec.
.TD10 Thanks for waiting
Thanks for waiting
==========================================================================
.UN
[USER NAME]
screen output
file output
<1.00> implemented
Displays user's name on the screen and writes it to output file.
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
User: John Doe User:John Doe
.UN
==========================================================================
.WS
[WRITE SCORE]
file output
<1.00> implemented
Writes value of score to output file
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
.UN John Doe won John Doe
Score:5000 Your score is:5000
.SS5000 You're a winner!
Your score is:
.DS
." won
.CR
."Score:
.WS
.CR
You're a winner!
==========================================================================
.ZS
[ZERO SCORE]
no output
<1.00> implemented
Resets score value to zero
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
Score: Score:5000
.DS Oops! You just lost
all your money!
.ZS Score:0
Oops! You just lost
all your money!
Score:
.DS
==========================================================================
.}x
[FORWARD BRANCH WITH RESET]
no output
<1.01> implemented
Operates exactly like the .>x forward branch except that if an
end of file condition is found before the .@x marker, the file
is reset instead of exiting.
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
PRESS A or B: PRESS A or B:<B>
.[AB] You pressed B
.@A PRESS A or B:<A>
You pressed A You pressed A
.}X
.@B
You pressed B
.>X
==========================================================================
.{+
[ENABLE FILE RESET]
no output
<1.01> implemented
This command turns on the automatic file reset.
Normally when the end of your source file is reached the program
ends and control is returned to the BBS. If this is SET, your
source file will be reset when an end of file condition is reached
and will start over from the beginning.
Care should be used when setting this flag since no exit from
the program is possible after the .{- command has been issued.
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
.{+ Press A or B <A>
Press A or B Press A or B <A>
.[AB] Press A or B <B>
.@A
.>C
.@B
.{-
==========================================================================
.{-
[DISABLE FILE RESET]
no output
<1.01> implemented
This command restores the end of file exit. This command
is not needed unless the .{+ command has been used.
{EXAMPLE}
See .{+ command
==========================================================================
.^n
[INSERT ASCII CHARACTER]
file output
<1.01> implemented
This command permits you to add characters to the file based on their
ASCII values where "n" represents the ASCII value of the character you
wish to output to your file. Valid range for this command is integer
values between 1 and 254.
This command is handy for inserting RA/QBBS text file commands such
as ^A (ASCII #1) to make the file wait for the user to press return.
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
.^33 !* The ASCII value for
.^42 "!" is 33.
The ASCII value for The ASCII value for
"!" is 33. "*" is 42.
The ASCII value for
"*" is 42.
==========================================================================
.!?
[DISPLAY SYSTEM INFO]
screen output
<1.01> implemented
This command is for the sysop's convenience. It displays the current
settings of various system flags and values. Although rather limited
at the moment, as more system variables and flags are added to future
versions of Crossover, they will be included in this output.
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
.!? APPENDING:ON
FOREGROUND VALUE:7
BACKGROUND VALUE:0
FLASHING TEXT:OFF
RESET FLAG:OFF
==========================================================================
.+Sn
[INCREMENT SCORE]
no output
<1.00> implemented
Raises value of score the amount specified by n.
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
.DS 0
5000
.+S5000
.DS
==========================================================================
.-Sn
[DECREMENT SCORE]
no output
<1.00> implemented
Lowers value of score the amount specified by n.
{EXAMPLE}
Source File Screen
-------------------- ------------------ -----------------
.DS 5000
4000
.-S1000
.DS
==========================================================================
[ S U M M A R Y O F C O M M A N D S ]
==========================================================================
(* FREEWARE & REGISTERED VERSION *) (* REGISTERED VERSION ONLY *)
.( Comment .UN User Name
.@ Marker .^ Insert character
.> Forward branch .} Resetting forward branch
.< Reverse branch .!? Display information
.[ Multiple choice .ZS Zero score
." Insert text in file .FL+ Flashing text on
.? Yes/No .FL- Flashing text off
.UT Multiple line text input .TD Time delay
.$ Single line text input .EX Dirty exit
.# Numeric input .-S Decrement score
.SB Space bar .+S Increment score
.CR Carriage return .PR Print text
.DT Date and time .DS Display score
.NA Toggle file appending .WS Write score to file
.RN Random branch .SE Security level branch
.CF Set foreground color .PUI Print user information
.CB Set background color .Password: Get a password
.CLS Clear screen .AN Branch on ANSI=true
.EO Erase output file.
.{- Turn off auto-reset
.{+ Turn on auto-reset
<*** End of file ***>